NetBIOS Name Registration

Macros
#define	CM_NB_GROUP   0x80
#define	CM_NB_UNIQUE   0x40
#define	CM_NB_POSTFIX_WORKSTATION   0x0
#define	CM_NB_POSTFIX_SERVER   0x20
#define	CM_NB_POSTFIX_DOMAINMASTERBROWSER   0x1b
#define	CM_NB_POSTFIX_DOMAINCONTROLLER   0x1c
#define	CM_NB_POSTFIX_MASTERBROWSER   0x1d

Functions
NQ_STATUS	nqRegisterNetBiosName (const NQ_CHAR *name)
NQ_STATUS	nqReleaseNetBiosName (const NQ_CHAR *name)
NQ_STATUS	nqRegisterNetBiosNameEx (const NQ_CHAR *name, const NQ_BYTE flags)
NQ_STATUS	nqReleaseNetBiosNameEx (const NQ_CHAR *name, const NQ_BYTE flags)

Detailed Description

Macro Definition Documentation

#define CM_NB_GROUP   0x80

#define CM_NB_UNIQUE   0x40

#define CM_NB_POSTFIX_WORKSTATION   0x0

#define CM_NB_POSTFIX_SERVER   0x20

#define CM_NB_POSTFIX_DOMAINMASTERBROWSER   0x1b

#define CM_NB_POSTFIX_DOMAINCONTROLLER   0x1c

#define CM_NB_POSTFIX_MASTERBROWSER   0x1d

Function Documentation

NQ_STATUS nqRegisterNetBiosName

(

const NQ_CHAR *

name

)

This function is called to register an abstract NetBIOS name. An abstract name is registered in addition to the host name and is served as its alias.

Parameters

name	Pointer to the name to register as a NetBIOS name.

Returns

NQ_SUCCESS or NQ_FAIL

See Also

nqReleaseNetBiosName()

NQ_STATUS nqReleaseNetBiosName

(

const NQ_CHAR *

name

)

This function is called to unregister an abstract NetBIOS name.

Parameters

name	Pointer to the name to release as a NetBIOS name.

Returns

NQ_SUCCESS or NQ_FAIL

Note

No check is made that the name to release was registered with a nqRegisterNetBiosName() call. It is possible to release the basic host name with this call.

See Also

nqRegisterNetBiosName()

NQ_STATUS nqRegisterNetBiosNameEx	(	const NQ_CHAR *	name,
		const NQ_BYTE	flags
	)

This function is called to register an abstract NetBIOS name. An abstract name is registered in addition to the host name and is served as its alias. This is an extended version of nqRegisterNetBiosName().

Parameters

name	Pointer to the name to register as a NetBIOS name.
flags	Combination of flags to designate unique or group name and postfix (e.g. CM_NB_UNIQUE|CM_NB_POSTFIX_SERVER)

Returns

NQ_SUCCESS or NQ_FAIL

See Also

nqReleaseNetBiosNameEx()

NQ_STATUS nqReleaseNetBiosNameEx	(	const NQ_CHAR *	name,
		const NQ_BYTE	flags
	)

This function is called to unregister an abstract NetBIOS name. This is an extended version of nqReleaseNetBiosName().

Parameters

name	Pointer to the name to release as a NetBIOS name.
flags	Combination of flags to designate unique or group name and postfix (e.g. CM_NB_UNIQUE|CM_NB_POSTFIX_SERVER)

Returns

NQ_SUCCESS or NQ_FAIL

Note

No check is made that the name to release was registered with a nqRegisterNetBiosNameEx() call. It is possible to release the basic host name with this call.

See Also

nqRegisterNetBiosNameEx()